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ABSTRACT y 

There is an increasing demand for good documentation of complex 
programs; in particular, the [desi gn of flow charts takes a lot of time 
and is a [strain on the programmer. For these reasons, flow charts are 
often neglected. This paper describes a program written in Fortran 
that does the tiresome work of drawing the^ flow chart of a program. 

The actual drawing is done with the aid of a SC 4020 and can easily 
be changed for any other plotter device. Such a flow chart gives the 
logical structure of a program, e.g., it shows the connections between 
the different parts of a program and its branches. This program not 
only can be used in the documentation of programs, but also to find logical 
errors and also to "clean up" (reorganize) a program which is in the 
stages of development. The same program can be used to draw PERT 
networks . _ * 
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INTRODUCTION 


A program can be logically described, as a set of elements A., 

J 

which contain the instructions, and a matrix C., which gives the 

Jk 

connections between these elements (JUMP instructions). (in PERT 
terms the elements A. are events, and the C. . activities.) Here the 
attempt is made to draw a two-dimensional picture of the logical 
structure of a program by disregarding the specific contents of the 
elements. To get this picture two facts are important. 

a) There is a hierarchy, namely the order by which the elements 
are called. This order would be unique if there were no 
closed loops. Therefore, the first aim is to achieve this 
unique order by handling the loops appropriately and then 

setting up the sequential order. (Level structure, y-coord- 

^ * 
inates . ) 

b) Usually there will be more than one element is one of these 
levels, so that the task is now to sort the elements in 

such a way that there will be as little crossing of connecting 
lines as possible; furthermore, similar elements shall be 
brought as close together as possible. (Branch structure, 
x-coordinates) . 


1) LEVEL STRUCTURE 


Given a set of elements A x . . .A and a connecting matrix, C. , 

II J y -L 


.1, , . . ,C, s j if element A. calls the elements A. ... A 
m 1 - 11 


m 


a 1 


J m 
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There may exist some elements for which m = 0, which means that those 
elements do not call any other element. These elements are defined as 
end elements. 

When the call matrix is given one can construct uniquely the 

reciprocal "get" - matrix G - which is defined by G = j . 

<3 } & J y 1 

G. = .1 in which the element A. is called "by the elements A. ...A, . 
0 ,m °m J J 1 3 m 

An element for which m = 0 is called an entry element. 

DEFINITION: 

A program is defined as a set of elements A^.-.A^ which are "blocks 

of instructions with the connecting matrix C. resp. G if the 

J > J y 

following conditions are fulfilled. 

1) there exists one and only one entry element. 

2) there exists at least one end element. 

3) there exists for each element j a number m ^ n, such that 
(G. , ) m contains the entry element (from every element there 
must exist at least one path to the entry point). 

k) there exists for each element j a number m £ n, such that 

(C ) m contains at least one end element (from every element 
there must exist at least one path to an end element) . 

In the following, the elements A. i . . .A n are represented by their sub- 
scripts. In order to be able to achieve a unique hierarchy of the 
elements in a simple way it is useful to break up the loops so that the 
calling sequence runs only in one direction. 
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DEFINITION : 

If (C. ) m has m diagonal elements and m is the first number 

3 

for which diagonal elements occur, then the diagonal elements form 

a simple loop of m^ order. (One can prove that if one element (C. ) m 
— - J,k 

is a diagonal element, then the whole set of elements which are involved 

have the same property. Also that the definition with the matrix (C. , ) Tn is 

j j & 

equivalent to this definition.) If the number of diagonal elements is 
bigger than m, then they form a multiple loop of m order. 

DEFINITION ; 

A program is called cyclic, if it contains at least one loop of 
order m, 2 ^ m ^ n - 2, and noncyclic if it does not contain any such 
loops . 

In order to handle a program as a sequential structure it has to 
be noncyclic. Therefore a cyclic program has to be made noncyclic 
by breaking up the loops. This can be done by introducing a new end 
element in the following way. 

"bh 

Lemma ; There exists at least one element of a loop of m order 
which is called by at least one element which is not an element of this 
loop and also at least one element which calls an element, which is not 
part of the loop. 

Proof: If (C.- , ) m has only loop elements, then any potent of (C. , ) m 

j,h • j,k 

would only have loop elements, which would contradict (4). If (C. ) m 

i ] ) k 

is to have at least one element which is not a loop element, at least 

one C. , of a loop element has to have one element which is no part of 
j ,k 

the loop. As (0^ ^) m and (G^ ^) ra are equivalent in defining a loop 
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the same arguments apply to the matrix G. . 

J f 

Let be an element, which is called by an element which is not a 

loop element. Then a new element A^ + ^ is introduced (with the name -A^ ) 

and a new C - , = 0 is obtained as a new end element A . , . G . , in 

n+l,k n+1 j,k 

which k is a member of the loop is then replaced by G^ + ^ ^ 

If possible the same end element is used for different simple 
loops which are parts of a multiple loop and also for loops of different 
order . 

After all loops are broken up the program is no longer cyclic. 

For noncyclic programs, it is possible to define a unique sequential 
structure called the level structure. 

DEFINITION : 

The level JL. of an element is defined by: 

J 

1) The entry element has the level 1. 

2) If an element k, which is called by j and other elements 

j . . • j<j with levels JL ,.. n JL , then JL = JL. + 1. 

1 J 1 ^cr J K J 

Lemma : The levels ax’e uniquely defined. 

Proof : If one element j were to have two different levels JL. and JL. 

<3 J 

then there must exist also at least one element k which calls the element 
j whose level is not uniquely defined. So that at least the entry 
element can be reached and therefore the level of the entry element would 
not be uniquely defined which contradicts l). 
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In the drawing of the flow charts each element is assigned a y-coord- 
inate according tQ-its level 


y j = A ' h 


2) BRANCH STRUCTURE 


After one has accomplished the hierarchial structure one has to 

sort the elements of the same level. The sorting should give a clear 

picture of branch structure. Therefore the aim is to avoid the 

crossing of lines as much as possible, vhich is equivalent to minimizing 

the distance betveen the elements. 

The elements 1, . . . n, vith the y i ***y n and * the connecting lines 

C. . are given. These can also be represented by S . . = C . + G. ^ 

J,k j,k j,k 

(S. , ) is the matrix which contains all possible connections between 

J J & 

the elements . Given furthermore a weight function H. (y.-y, ), then 

J K 

the task could be principally defined as 


s j,k H j,k (y r y * ) ' 


by varying the order in vhich the elements occur in each level and x. 

J 

subject to the restriction that |x.-x. | 2 1 if y. = y, , where H. . is a 

3 £ 3 & J jK. 
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weight function which gives more weight to the elements with the 
least level difference. Furthermore, elements of the same structure 
should he put together as close as possible. This tasjc can be solved 
approximately in two steps : 

a) Order the elements in a level. 

b) Calculate the x-coordinates (in some crude way of linear 
programming) . 

Definitions: Ordering - a) 

1. identical elements; an element is identical with an 

element if S. , = S.„ . k = 1, ...n, 

Ji,k J 2 ,k * ji 

2. chain elements. An element j is a chain element if C. , 

and G. , contain only one element. 

J 

T> 

3* S . , is the reduced S. , and is obtained from S by 

j,k 

a) only one of the identical elements j is retained and 

has the multiplicity m. 

J 

b) chain elements are eliminated from S. and identical 

J y & 

elements are taken out again. 

( 1 ) R 

4. The basic matrix B; / is the matrix obtained from S . , in 

j,k 

which the chain elements are restored, but only one element 
for each level in a specific chain so that an appropriate 
place for them can be found. To these chain elements *the 
multiplicity m has to be assigned, which corresponds to 
their appearance in the chain as identical elements. 
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(o) 

The sorting is done first for B. ' which is derived from the two 
HR 

time reduced matrix S. , . It gives a uniquely defined order for elements of 

B. This order is retained for sorting 8. , . 

0 j h 3 3 ^ 


The sorting is done by following a path through the program. 

It is useful to define the following numbers : 

1) a number Z. which is +1 if j is reached from a lower level 
and -1, if j is reached from a higher level. 

2) K. is a vector which contains those elements whose 

0 

order is already determined. 


3) R. and R . are vectors which give the order of an element 
3 3 

j. Initially R a . = n a . +1, where n a . is the beginning 
J J J 

of level JL. 


a 

n b 

= 2 m^ with < & . 

j£ 

and R e . = n e . with 

J 3 


e 

"b 

* 1 } 
K. 
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SL 0 

^ ^ j > R ^ = m J P^ ace 8,11 element Is determined. 


k) d is a vector, which contains the elements S. , from K 

J OA j 

whose level difference is one. 

5) m. is the vector which gives the multiplicity. 

Sorting starts at an arbitrary element which is not an only 

element in a level. The most convenient way is to take an element of 

the level, which contains the most items, and Z ■ l. 

ji > 

R 6 ^ = R^j! + and - R 6 ^ if y.. - y. x . If the sorting 

procedure has reached the element K., the element K. is found 

<3 J+l 

by the following process 


(1) 


K 


<5+1 


S K. 


jo,a 


J o S J 


if there is an element K. so that K is reached from the same 

Jct j+i 

direction as K where K. is the first element counting from the 

J Jrr 


end which fulfills the condition 




Jo 


""J 


If there is not such an 


element the first element K . , _ = S, then Z w. , = -Zrr. is taken. 

0+ 1 J K CT ^ a 0+1 <3 


(2) If there exists a with Xg 

j<j,a ! 


< 

J+1 V- 


and R 

j+i s k. 


“ en K j+i * 


o,a 
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(5) Furthermore, if now the so defined K. ,, is taken and there is 

0+1 

a .d^ k = 1 . . . ,n^ , so that 


R a , £ R a T , then 




<3+1 


K 0+l = \ 


has then the same value, as the element, from which cL has 
0+1 ■ k 
heen originally determined. 


(h) The element K . is then eliminated out of the matrix B so that 
0+1 

it does not appear again. 


,e _ „a 
k 


(5> R t ■ R l.„ + V.., b», • 


0+1 "j+1 "o+l J 


.. +1 if 7 i = y k. +1 
0+1 0+1 


The procedure is so destined to achieve the two aims : 

1. to make as rare as possible (by means of the vector d.) 

J 

the crossing of lines which connect elements with only' 
one level difference. 

2. to bring so close as possible such elements which belong 
logically together by keeping the vertical direction of the 
elimination as long as possible. 
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The actual program is still more complicated in detail, but this 

is not essential for the main features described here. These details 

can be seen from the Fortran program. 

After this procedure has been applied to this basic matrix 

; it is repeated for the matrix and S. , with the initial 

JjK J> K 

a e (2 (1) 

values R . .R . given by the just processed basic matrix B . , , B 
Jr J J> K 

respectively. 

(b) Calculation of the x-coordinates 

After the sorting is done and every element has obtained its place 

the actual calculation of the x-coordinates starts. This is done in a 

rather crude and simple way. The row in the level £ = £ y which has 

the most elements is taken and a matrix C. . is constructed which gives 

J; K 

all connections starting from this row. The elements are ordered in the 
sequence in levels with e x = e x = + r e 3 = e^, 

where N is the number of levels. Inside the levels are ordered according 

a * 

to R . The elements are now in an unique order. C. , gives then the 

j J> K 

connections of elements with higher numbers to those with lower numbers. 

The distance between the elements in the -t row, whose order is given 

IIlcLX 

£L 

by R .is set arbitrarily to one. 

J 


Assume that the x-coordinates have been determined up to the level 
e^, then the x-coordinates in e^ + -^ are computed by the following pro- 
cedure. If j is an element of this level 
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l) X\j - Max 






is the number of 


* 

elements in the C. v 

0> x 


oL 

where the order of the elements are given by R 

element then X._, is set artificially to -6. 

J - -L 


. • 

o 


If j is the first 


2 ) should there be an end element so that C . , = 0, 

0> K 

brought in with 


this element is 


x . 
0 


X . + 1 

0-1 


and if this j is the first element in a level 


then 


x. 

0 


= x 


0+1 


- 1 


j) the a 



i N - 

A, o 0=1 ~0,* u 


X 


i 
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The graphs shown are done by a SG 4020, but the program can be 
easily changed for use with any other plotter device. If there .are 
many elements the plotting is done on several pages.' If there is 
more than one entry for a program, an artificial entry with name '//' 
is provided in order to connect the various entries of a program. 
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The dimension of the program is that two hundred different elements 
can be handled and one element can be connected to as many as 20 
other elements. The program is written in Fortran II and contains 
approximately 1600 Fortran statements. 

In conclusion, it seems that this program (including the 
graphical output) can be a very powerful tool in documentation, 
analysis and cleanup of a program. It should also be of use for 
drawing of big networks like PERT networks. 
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Flow Chart of a non -cyclic program 





